<html xmlns:v="urn:schemas-microsoft-com:vml"
xmlns:o="urn:schemas-microsoft-com:office:office"
xmlns:w="urn:schemas-microsoft-com:office:word"
xmlns="http://www.w3.org/TR/REC-html40">
	

<head>
<meta http-equiv=Content-Type content="text/html; charset=us-ascii">
<meta name=ProgId content=Word.Document>
<meta name=Generator content="Microsoft Word 11">
<meta name=Originator content="Microsoft Word 11">
<link rel=File-List href="readme_files/filelist.xml">
<link rel=Edit-Time-Data href="readme_files/editdata.mso">
<!--[if !mso]>
<style>
v\:* {behavior:url(#default#VML);}
o\:* {behavior:url(#default#VML);}
w\:* {behavior:url(#default#VML);}
.shape {behavior:url(#default#VML);}
</style>
<![endif]-->
<title>Managed Stack Explorer - Help</title>
<!--[if gte mso 9]><xml>
 <o:DocumentProperties>
  <o:Author>sraaleti</o:Author>
  <o:LastAuthor>sraaleti</o:LastAuthor>
  <o:Revision>2</o:Revision>
  <o:TotalTime>3</o:TotalTime>
  <o:Created>2005-07-14T01:45:00Z</o:Created>
  <o:LastSaved>2005-07-14T01:45:00Z</o:LastSaved>
  <o:Pages>1</o:Pages>
  <o:Words>723</o:Words>
  <o:Characters>4126</o:Characters>
  <o:Company>Microsoft Corporation</o:Company>
  <o:Lines>34</o:Lines>
  <o:Paragraphs>9</o:Paragraphs>
  <o:CharactersWithSpaces>4840</o:CharactersWithSpaces>
  <o:Version>11.6408</o:Version>
 </o:DocumentProperties>
</xml><![endif]--><!--[if gte mso 9]><xml>
 <w:WordDocument>
  <w:SpellingState>Clean</w:SpellingState>
  <w:GrammarState>Clean</w:GrammarState>
  <w:ValidateAgainstSchemas/>
  <w:SaveIfXMLInvalid>false</w:SaveIfXMLInvalid>
  <w:IgnoreMixedContent>false</w:IgnoreMixedContent>
  <w:AlwaysShowPlaceholderText>false</w:AlwaysShowPlaceholderText>
  <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel>
 </w:WordDocument>
</xml><![endif]--><!--[if gte mso 9]><xml>
 <w:LatentStyles DefLockedState="false" LatentStyleCount="156">
 </w:LatentStyles>
</xml><![endif]-->
<style>
<!--
 /* Style Definitions */
 p.MsoNormal, li.MsoNormal, div.MsoNormal
	{mso-style-parent:"";
	margin:0in;
	margin-bottom:.0001pt;
	mso-pagination:widow-orphan;
	font-size:12.0pt;
	font-family:"Times New Roman";
	mso-fareast-font-family:"Times New Roman";}
h1
	{mso-margin-top-alt:auto;
	margin-right:0in;
	mso-margin-bottom-alt:auto;
	margin-left:0in;
	mso-pagination:widow-orphan;
	mso-outline-level:1;
	font-size:24.0pt;
	font-family:"Times New Roman";}
h3
	{mso-margin-top-alt:auto;
	margin-right:0in;
	mso-margin-bottom-alt:auto;
	margin-left:0in;
	mso-pagination:widow-orphan;
	mso-outline-level:3;
	font-size:13.5pt;
	font-family:"Times New Roman";}
@page Section1
	{size:8.5in 11.0in;
	margin:1.0in 1.25in 1.0in 1.25in;
	mso-header-margin:.5in;
	mso-footer-margin:.5in;
	mso-paper-source:0;}
div.Section1
	{page:Section1;}
-->
</style>
<!--[if gte mso 10]>
<style>
 /* Style Definitions */
 table.MsoNormalTable
	{mso-style-name:"Table Normal";
	mso-tstyle-rowband-size:0;
	mso-tstyle-colband-size:0;
	mso-style-noshow:yes;
	mso-style-parent:"";
	mso-padding-alt:0in 5.4pt 0in 5.4pt;
	mso-para-margin:0in;
	mso-para-margin-bottom:.0001pt;
	mso-pagination:widow-orphan;
	font-size:10.0pt;
	font-family:"Times New Roman";
	mso-ansi-language:#0400;
	mso-fareast-language:#0400;
	mso-bidi-language:#0400;}
</style>
<![endif]-->
</head>

	

<body lang=EN-US link=blue vlink=blue style='tab-interval:.5in'>

<div class=Section1>

<h1>Manage Stack Explorer (MSE) - Help</h1>

<h3>Table of Contents</h3>

<p class=MsoNormal><a href="#gen1">1. General Information</a></p>

<p class=MsoNormal style='margin-left:.5in'><a href="#gen1.1">1.1 About Managed
Stack Explorer</a></p>

<p class=MsoNormal><a href="#use2">2. Using Managed Stack Explorer</a></p>

<p class=MsoNormal style='margin-left:.5in'><a href="#use2.1">2.1 Installation</a></p>

<p class=MsoNormal style='margin-left:.5in'><a href="#use2.2">2.2 General Usage</a></p>

<p class=MsoNormal style='margin-left:.5in'><a href="#use2.3">2.3 Using the GUI</a></p>

<p class=MsoNormal style='margin-left:.5in'><a href="#use2.3.1">2.3.1 Getting
information about a process</a></p>

<p class=MsoNormal style='margin-left:.5in'><a href="#use2.3.2">2.3.2 Viewing a
process's threads</a></p>

<p class=MsoNormal style='margin-left:.5in'><a href="#use2.3.3">2.3.3 Viewing a
stack trace</a></p>

<p class=MsoNormal style='margin-left:.5in'><a href="#use2.3.4">2.3.4 Saving a
stack trace</a></p>

<p class=MsoNormal style='margin-left:.5in'><a href="#use2.3.5">2.3.5 Auto
refreshing the thread list</a></p>

<p class=MsoNormal style='margin-left:.5in'><a href="#use2.3.6">2.3.6 Auto
refreshing stack traces</a></p>

<p class=MsoNormal style='margin-left:.5in'><a href="#use2.3.7">2.3.7
Periodically logging stack traces</a></p>

<p class=MsoNormal style='margin-left:.5in'><a href="#use2.4">2.4 Using the
Command Line</a></p>

<p class=MsoNormal style='margin-bottom:12.0pt'><o:p>&nbsp;</o:p></p>

<div class=MsoNormal align=center style='text-align:center'>

<hr size=3 width="100%" align=center>

</div>

<p class=MsoNormal style='margin-bottom:12.0pt'><a name=gen1></a><o:p>&nbsp;</o:p></p>

<h2>1. General Information</h2>

<h3><a name=gen1.1></a>1.1 About Managed Stack Explorer</h3>

<p class=MsoNormal>Managed Stack Explorer (MSE) is a lightweight tool that
provides a quick and easy way to monitor managed processes and their stacks.
The ability to view a programs stack and how it changes over time is an
important method in determining reasons for possible errors or hand. MSE
provides a simple interface to allow you to monitor multiple processes at once
and build periodic stack log files. MSE works by quickly attaching to a process
when a stack trace is requested and the detaching the second the stack trace
has been retrieved. This way the interference in the normal operation of the
process is minimized. <br>
<br>
Managed Stack Explorer is both a command line tool as well as a graphical tool.
If you pass in parameters to the program the program will run as a command line
program. However, if you just execute the program&#8217;s executable then it will
open up as a GUI. <a name=use2></a></p>

<h2>2. Using Managed Stack Explorer</h2>

<h3><a name=use2.1></a>2.1 Installation</h3>

<p class=MsoNormal>MSE currently comes with 2 files: MSE.exe, CorApi2.dll. As long as these for files are together in the same
directory MSE will work. <a name=use2.2></a></p>

<h3>2.2 General Usage</h3>

<p class=MsoNormal>MSE is a .NET 2.0 program and therefore can only get the
stack trace of other .NET 2.0 programs. <a name=use2.3></a></p>

<h3>2.3 Using the GUI</h3>

<h4><a name=use2.3.1></a>2.3.1 Getting information about a process</h4>

<p class=MsoNormal>General information about any managed process is provided by
just clicking on it in the process list. The group box below will populate with
some useful information about the process. If you want to customize the data
shown just right click on the group box and choose <i>customize</i> <a
name=use2.3.2></a></p>

<h4>2.3.2 Viewing a process's threads</h4>

<p class=MsoNormal>To view all the threads of a process just double click the
process in the list. This will load the list of managed processes. A double
click is required here because getting the list of managed threads requires a
quick attach and detach to the program. Once you double click a list of managed
threads will populate the thread list box. <a name=use2.3.3></a></p>

<h4>2.3.3 Viewing a stack trace</h4>

<p class=MsoNormal>Once you have a list of the managed threads you can view the
stack trace of any or all of the threads. Just highlight the ones you want and
press enter (or hit the view stack trace button in the toolbar). This will open
the stack trace panel which displays the stack for the threads you selected. <a
name=use2.3.4></a></p>

<h4>2.3.4 Saving a stack trace</h4>

<p class=MsoNormal>When the stack pane is open you can either press Control + S
or press the save button in the toolbar to save the stack trace to a file. <a
name=use2.3.5></a></p>

<h4>2.3.5 Auto refreshing the thread list</h4>

<p class=MsoNormal>In the toolbar there is an auto refresh thread list button.
Clicking this button will cause the list of threads to automatically update
periodically. This behavior isn't on by default because update the thread list
requires MSE to attach and detach from the process. <a name=use2.3.6></a></p>

<h4>2.3.6 Auto refreshing stack traces</h4>

<p class=MsoNormal>In the toolbar there is an auto refresh stack trace button.
Clicking this button will cause the currently viewed stack trace to
automatically update periodically. This behavior isn't on by default because
updating the stack trace requires MSE to attach and detach from the process. <a
name=use2.3.7></a></p>

<h4>2.3.7 Periodically logging stack traces</h4>

<p class=MsoNormal>This is one of the most important features of MSE. This
allows you to build a log file over time of the stacks of several processes and
specific threads in those processes. This allows you to view a file which shows
how the stack trace of a process changes over time. To start stack logging
choose the threads of a process you want to log the stack of and press the log
stack button in the toolbar. This will make the threads in the thread list and
the process in the process list you are logging turn yellow. This will keep
logging until you chose the process and press the stop log button. <a
name=use2.4></a></p>

<h3>2.3 Using the Command Line</h3>

<p class=MsoNormal style='margin-bottom:12.0pt'>To get instructions on the
command line attributes of MSE call &quot;MSE /?&quot; from the command line. </p>

<div class=MsoNormal align=center style='text-align:center'>

<hr size=3 width="100%" align=center>

</div>

<p class=MsoNormal><br>
<br>
Managed Stack Explorer &copy; 2005 Microsoft Corporation </p>

</div>

</body>

</html>
